import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import HelpInfoSub from './help-install-sub.mdx';

# Linux

## 安装依赖 {#install-depend}

首次部署才需要安装依赖，更新部署见下方：[更新版本](#update)

<Tabs>
<TabItem value="centos" label="Centos">

```bash
yum install -y java-1.8.0-openjdk unzip
```

</TabItem>
<TabItem value="ubuntu" label="Ubuntu">

```bash
apt update
apt install -y openjdk-8-jre-headless unzip
```

</TabItem>
</Tabs>


## 下载并解压

:::info 安装说明

下面命令中第一行表示默认安装到用户目录下: `~/zfile` 下。

对于 `root` 用户, `~`  = `/root`,  `~/zfile` 表示在 `/root/zfile` 路径下。

对于其他用户,  `~` = `/home/用户名` 表示在 `/home/用户名/` 路径下。如对于 `oracle` 用户,  `~/zfile` 则表示安装在 `/home/oracle/zfile` 下。

如需更改安装路径, 请自行修改，如 `export ZFILE_INSTALL_PATH=/data/zfile`，表示安装在 `/data/zfile` 路径下。

:::

```bash showLineNumbers
# highlight blue next
export ZFILE_INSTALL_PATH=~/zfile                        # 声明安装到的路径
mkdir -p $ZFILE_INSTALL_PATH && cd $ZFILE_INSTALL_PATH   # 创建文件夹并进入
wget --no-check-certificate https://c.jun6.net/ZFILE/zfile-release.war          # 下载 zfile 最新版
unzip zfile-release.war && rm -rf zfile-release.war      # 解压并删除压缩包
chmod +x $ZFILE_INSTALL_PATH/bin/*.sh                    # 授权启动停止脚本
```

## 启动项目

```bash showLineNumbers
~/zfile/bin/start.sh       # 启动
```

启动后浏览器访问 **`http://ip:8080`** 即可，如启动后无法访问，请检查 **`端口是否冲突`** 或 **`防火墙/安全组是否开启`**。

简单检查方式为在服务器执行 `curl http://127.0.0.1:8080`
- 如返回 `curl: (7) Failed connect to 127.0.0.1:8080; Connection refused` 表示未启动成功。
- 如返回 `<!DOCTYPE html> <html lang="zh-CN">……` 等字样表示启动成功，如启动成功但通过服务器 IP 无法访问，那一般就是防火墙/安全组未放行端口问题。


## 其他命令 {#command}

以下为默认未修改安装路径下的情况，**如修改了安装路径请自行更改命令所在路径**。

```bash showLineNumbers
~/zfile/bin/start.sh       # 启动
~/zfile/bin/stop.sh        # 停止
```

## 配置文件路径 {#config}

如需修改配置文件，配置文件路径为：

```bash showLineNumbers
~/zfile/WEB-INF/classes/application.properties
```

## 更新版本 {#update}

:::caution

更新程序前务必停止程序再进行操作，命令见下方黄色高亮部分。

:::

如果没修改过安装路径，则停止程序后，删除安装文件夹即可，默认命令为：

如修改过安装路径，则替换下方命令中的 `~/zfile` 部分为你的安装路径即可，见下方蓝色高亮部分：





```bash showLineNumbers
# highlight yellow next
~/zfile/bin/stop.sh                                                 # 停止程序
# highlight yellow next
rm -rf ~/zfile                                                      # 删除安装文件夹

# 重新下载安装最新版
# highlight blue next
export ZFILE_INSTALL_PATH=~/zfile                                   # 声明安装到的路径
mkdir -p $ZFILE_INSTALL_PATH && cd $ZFILE_INSTALL_PATH              # 创建文件夹并进入
wget --no-check-certificate https://c.jun6.net/ZFILE/zfile-release.war                     # 下载 zfile 最新版
unzip zfile-release.war && rm -rf zfile-release.war                 # 解压并删除压缩包
chmod +x $ZFILE_INSTALL_PATH/bin/*.sh                               # 授权启动停止脚本

~/zfile/bin/start.sh                                                # 启动项目
```

## 帮我安装🔍
<HelpInfoSub />
